home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / converte / cnvrtham.lha / ConvertHAM.doc < prev    next >
Encoding:
Text File  |  1993-09-21  |  3.6 KB  |  109 lines
  1.  
  2.                 ConvertHAM v1.3
  3.                 ---------------
  4.  
  5.                  ©1992-94 David Kinder
  6.                  ---------------------
  7.  
  8. Introduction
  9. ------------
  10.  
  11. ConvertHAM is a little utility to convert HAM (Hold-And-Modify) IFF pictures
  12. into ordinary IFF ILBM pictures. On an ordinary Amiga the converted pictures
  13. can have between 2 and 32 colours; on an AGA equiped machine the maximum
  14. number of colours is 256. I quite often want to use a piece of a HAM picture
  15. in DPaint for my own work, and getting at the data proved very difficult.
  16. Okay, so I could have bought one of the commercial conversion programs
  17. available, but I don't have that sort of money to spend and anyway I don't
  18. really need the complexity they offer, so I wrote this.
  19.  
  20. Running ConvertHAM
  21. ------------------
  22.  
  23. Just type 'ConvertHAM' at the CLI or click on it's icon. Note that both
  24. 'reqtools.library' v38+ and 'iff.library' v23+ must be in the current LIBS:
  25. directory for ConvertHAM to be able to run.
  26.  
  27. Using ConvertHAM
  28. ----------------
  29.  
  30. ConvertHAM is controlled using the gadgets and the menu. Looking at the
  31. window, the layout is:
  32.  
  33. Loaded             Gives the name of the HAM picture currently
  34.             loaded into memory.
  35.  
  36. Colours            Use the slider to select how many colours you wish
  37.             the converted picture to use. Obviously the best
  38.             results are obtained by using the most colours.
  39.  
  40. 'Load' gadget           The file requester to allow you to select a HAM
  41.             picture to load in, erasing the HAM picture
  42.             currently in memory.
  43.  
  44. 'Save' gadget           When active, allows you to save a converted picture.
  45.  
  46. 'Free' gadget           Frees memory by closing the screen (if active) and
  47.             flushing any HAM picture out of memory.
  48.  
  49. 'Screen' gadget         If active brings the screen to the front of the
  50.             display.
  51.  
  52. 'Convert HAM picture'   Initiates the conversion routine. The currently
  53.             loaded HAM picture is analyzed. After a short pause
  54.             the program will then open a screen and draw the
  55.             converted picture into the screen. While the program
  56.             is working you can press the 'ESC' key to stop.
  57.  
  58. 'About' gadget        Some information about the program.
  59.  
  60. Status            Tells you what the program is currently doing.
  61.  
  62. The options in the menu are:
  63.  
  64. Load HAM        Same as 'Load' gadget.
  65. Save IFF        Same as 'Save' gadget.
  66. Free Mem        Same as 'Free' gadget.
  67. About            Same as 'About' gadget.
  68. Quit            Quits ConvertHAM.
  69.  
  70. A quick example
  71. ---------------
  72.  
  73. When the program has started, click on the 'Load' gadget. Find a disk with
  74. some HAM pictures on it then use the file requester to select a HAM file.
  75. ConvertHAM will load the picture. Click on the 'Convert HAM Picture' gadget
  76. and wait until the program has finished drawing the converted picture on the
  77. screen. Go back to the ConvertHAM window and click on the Save gadget, then
  78. use the requester to select the name of the file to save to, e.g.
  79. 'RAM:Test.pic'. Now you can load 'Test.pic' into DPaint or whatever you
  80. wish.
  81.  
  82. Finally
  83. -------
  84.  
  85. This program was written in with HiSoft's Devpac assembler. Thanks to
  86.  
  87. Niço Francois        Author of 'reqtools.library'
  88. Christian Weber     Author of 'iff.library'
  89.  
  90. History
  91. -------
  92.  
  93. v1.0    First release.
  94.  
  95. v1.1    Improved appearance when running under AmigaDOS2.
  96.  
  97. v1.2    ConvertHAM now behaves if the system font is not topaz/8.
  98.     Menus have new look for AmigaDOS3.
  99.     Redesigned main window; new 'About' gadget; slider gadget to
  100.     select colours.
  101.     Changed from 'req.library' to 'reqtools.library'.
  102.     Now requires 'iff.library' v23 or higher to avoid a bug that
  103.     crashes ConvertHAM while saving a picture on 68000 machines.
  104.     On AGA machines converted pictures can have up to 256 colours.
  105.  
  106. v1.3    Window redrawn correctly after resizing while processing.
  107.     Slightly improved menus.
  108.     More accurate testing for AGA chips.
  109.